From: Colin Walters <walters@verbum.org>
Date: Tue, 1 Aug 2017 13:12:16 +0000 (-0400)
Subject: docs/pull: Finish incomplete docs for pull@hash syntax
X-Git-Tag: archive/raspbian/2022.1-3+rpi1~1^2~4^2~33^2~61
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=fbefe875c77e03b9070f1f6b5e3f0ea085749ba7;p=ostree.git

docs/pull: Finish incomplete docs for pull@hash syntax

Closes: https://github.com/ostreedev/ostree/issues/1043

Closes: #1045
Approved by: guyshapiro
---

diff --git a/man/ostree-pull.xml b/man/ostree-pull.xml
index 394a29c2..dd901aa2 100644
--- a/man/ostree-pull.xml
+++ b/man/ostree-pull.xml
@@ -136,8 +136,11 @@ Boston, MA 02111-1307, USA.
         </para>
 
 	<para>
-	  A special syntax in the <literal>@</literal> character allows
-	  specifying a specific commit to retrieve from a branch.  This
+    A special syntax in the <literal>@</literal> character allows
+    specifying a specific commit to retrieve from a branch.  The
+    use cases for this are somewhat similar to pulling a specific
+    git tag; one could e.g. script a system upgrade to a known-good
+    version, rather than the latest from the content provider.
 	</para>
 
     </refsect1>